RiverSync
SPEC-DDD-DVC · v0.3
28 June 2026
Owner: Platform team

Devices & telemetry — the device bounded context

The device registry from commissioning to decommissioning, the telemetry plane — ingest, time-series store, live stream — alert evaluation and acknowledgement, the product & schema catalogs, and remote device commands for every frigo / koelkast unit in the field. A core subdomain: the monitored converged micro data center is the product.

DraftCore subdomainRegistry · telemetry · catalog
Drill-down of the master domain architecture. Requirements: SPEC-APP-PTL (PTL-1…3, PTL-5) + SPEC-APP-ADM (ADM-2). Boundaries, routes and events render from domain/domain-catalog.js — definitions are never copied per document.

1Ownership & boundaries

The Devices service owns two stores with one boundary between them: the relational registry (Device, Alert) and the time-series plane outside Postgres. Devices ingest over mTLS directly — never through the BFFs or the user gateway — and only Alert rows cross into the relational model (SVC-9, the ⚠ the ERD records under PTL-1).

Reads from: Structure (SiteId) · Tenancy (CustomerId) · Coverage (the scope resolver for every partner read). Portal is the primary client; commissioning arrives from the won-deal saga.

2Ubiquitous language

The words this context uses — the same in code, conversation and spec.

3Aggregates & invariants

The consistency boundaries — one root each, guarding its invariants in a single transaction; cross-aggregate ties are by identity.

4Context relationships

How this context meets its neighbours, with the integration pattern named on each edge.

5Physical view — the service API

The deployment mapping: this context becomes the Devices service. Paths relative to api.riversync.com/v1, except the ingest plane; access notation per the master.

RiverSync Co., Ltd. · BangkokSPEC-DDD-DVC · 1 of 2

6Domain events

The past-tense facts this context publishes (and consumes) — its share of the platform's published language.

7Invariants in play

The modeling rules that bind this context — the master holds the full set; data integrity stays with the ERD drill-downs.

8Revision history

VersionDateChanges
0.112 Jun 2026First draft — split proposed with SPEC-DDD v0.1 (as the Fleet domain)
0.213 Jun 2026Renamed from Fleet — the service is now Devices & telemetry (SVC-DVC, /devices route prefix, SPEC-DDD-DVC); vocabulary change only, ownership and boundaries unchanged (SPEC-PRD v0.12)
0.328 Jun 2026Reframed as a Domain-Driven Design context (with the set, SPEC-DDD v0.14) — leads with ubiquitous language & aggregates (Device, Alert, ProductFamily, TelemetrySchemaFamily) and the context relationships (customer/supplier to Support via alert.raised; consumes deal.won from Sales). Classified a core subdomain; the API is demoted to the physical view. No ownership change.
RiverSync Co., Ltd. · BangkokSPEC-DDD-DVC · 2 of 2